home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
tex
/
digex104.zip
/
DIGEXT.DOC
< prev
next >
Wrap
Text File
|
1991-08-15
|
5KB
|
157 lines
DIGEXT - The Digest Extractor
This README documents digext v1.04a
COPYRIGHT
Copyright (C) 1991, Alvin Koh. All Rights Reserved.
Permission is granted to any individual or institution to use, copy, or
redistribute this software so long as it is not sold for profit,
provided this copyright notice is retained.
Feel free to enhance the program, but do send me a copy of
your modifications.
Send bug reports, bug fixes and modifications to:
...!att!zpcp53!isakoh (UUCP) or
isakoh@zpcp53.att.com
DESCRIPTION
digext is for those who want to keep each digest issue in a
separate file without all those messy mail headers. This program
was inspired by Douglas Stumberger's and David Brown's undigest.
digext extracts digest issues from files (which may contain more
than one digest issue) and stores them in separate files.
Version 1.04a of digext recognizes the following digest formats:
Digest Stored as
------ ---------
INFO-ZIP IZIPvol.iss
INFO-C ICvol.iss
Info-IBMPC IIBMvol.iss
Info-Kermit IKERvol.iss
INFO-WIZARD IWIZvol.iss
UNIX-WIZARDS UWIZvol.iss
VIRUS-L VLvol.iss
where vol is the digest volume number (3-digit with leading 0)
and iss is the digest issue number (3-digit with leading 0)
If you do not like the naming convention used by digext, you can always
change it. You don't have to rename all your existing files too. Just
run them through digext to 're-extract' them. Don't send me the mods
if you do this.
Some things to note. If a digest issue already exists, it is not
overwritten. Carriage Returns in the digest files are not removed.
Non-MSDOS users who wish to do this can use programs like Rahul
Dhesi's flip.
USAGE
digext file [ file ... ]
e.g., digext infozip.digest infoc.digest infokermit.digest
This will extract digests from the files infozip.digest,
infoc.digest and infokermit.digest.
e.g., digext iz*.* ic*.*
This will extract digests from all files matching the
filespecs iz*.* and ic*.*.
Note: for some PC compilers, you will need to link to to
a wildcard expansion function for this to work. (See
COMPILING below).
COMPILING
UNIX System V or BSD:
cc -O -o digext digext.c -s
(The -s ld option cuts the executable size by close to a factor
of two on some systems. Seems to exist universally.)
Microsoft C 6.0:
cl digext.c setargv.obj /link /NOE
Linking with setargv.obj will allow command line wildcard expansion.
Add the path prefix to setargv.obj accordingly. /NOE is required to
prevent multiple definition errors when linking. setargv.obj is
distributed with MSC 6.0 in the lib directory. __STDC__ is
defined by default.
Turbo C 2.0:
tcc -A digext.c wildargs.obj
wildargs is functionally similar to MSC 6.0's setargv (see MSC 6.0
above). Also add the path prefix accordingly. wildargs.obj is
distributed with TC 2.0 in startup.arc.
If you are using the integrated development environment to compile
digext.c, be sure to set 'Options/Compiler/Source/ANSI keywords only'
to ON. This is to define the __STDC__ macro.
Borland C++ 2.0:
bcc digext.c wildargs.obj
See Turbo C 2.0 above. wildargs is distributed with BC++ 2.0 in the
lib directory. __STDC__ is defined by default.
VMS (tested under v5.2 with VAX C v3.0):
@make_digext
HISTORY
1.01 27 June 1991 Alvin Koh (isakoh@zpcp53.att.com)
Creation...
1.02 28 June 1991 David Kirschbaum (kirsch@usasoc.soc.mil)
Added include files for compilation under Turbo C.
1.03 6 July 1991 Alvin Koh (isakoh@zpcp53.att.com)
Added lookup table to support various digest types/formats.
I have only tested digext with INFO-ZIP and UNIX-WIZARDS digests
so far, as these are the 2 digests I subscribe to currently.
Please send me you bug reports, enhancements and new formats.
1.04 10 July 1991 Alvin Koh (isakoh@zpcp53.att.com)
Changed the various *unwieldy* sscanf formats to short and
more manageable ones. Volume and Issue variable changed from
char[80] to int.
1.04a 13 August 1991 Cave Newt (roelofs@amelia.nas.nasa.gov)
Tweaks for VMS/VAXC compilation (didn't like void main; return
status must be zero or else interpreted strangely; added wildcard
code). Tested a little bit on INFO-ZIP digests.
CREDITS
David Kirschbaum for testing, enhancing, and distributing digext
for me.
Greg Roelofs for the VMS/VAXC stuff.
------------------------------------------------------------------------------
Alvin Koh E-MAIL: ...!att!zpcp53!isakoh
isakoh@zpcp53.att.com
Phone: (065) 740-3413 (Timezone: GMT-8)
FAX: (065) 744-9577
------------------------------------------------------------------------------